home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / transbbs.lzh / PRTUSR / PRNTUSER.ASC < prev    next >
Text File  |  1991-12-04  |  8KB  |  181 lines
  1.                  Print User Program for Transcendence BBS
  2.                               Version 2.0
  3.  
  4.     First off, I must say that I am not responsible for any damage to your 
  5. system or any lost time due to the execution of this program. By using it, 
  6. you  accept  it as is and all responsibility is yours.  I  have  tried  to 
  7. maintain the integrity of this program. This program may not be altered in 
  8. any  way except by the author and those who have the authorization  to  do 
  9. so. This program is copyright (c) 1991, Twilight Zone Software. Written by 
  10. Wayne Watson of General Applications Software. It is designed to only work 
  11. for Transcendence BBS. I retain all rights to modify this program as I see 
  12. fit.
  13.  
  14.     Now,  this  program  was written to aid the Sysop and those  who  have 
  15. access to it,  to be able to search and print out information on the users 
  16. in a number of ways. It's main purpose was to allow the sysop to print out
  17. the users. If your USERS.DAT file got  corrupted  or  whatever,  then  you 
  18. would at least have a backup. While I was at it, I also added the  ability
  19. to print out mailing labels.
  20.  
  21.     When  the  program  is  executed,   you  will  be  presented  with  an 
  22. introduction screen.
  23.  
  24. MAIN MENU
  25. ---------
  26.  
  27. 1)  Search for User:
  28.     This will take you to the section that allows you to search for a user 
  29. in a number of ways. You can print the results of the search, send it to a 
  30. disk  file,  send it to the screen one at a time or continuously  if  more 
  31. than one user is found or get a mailing label of the user.  You can search 
  32. on multiple fields and have the program search for users that match ALL or 
  33. ANY of the fields.
  34.  
  35.     SEARCH FOR USER MENU
  36.     --------------------
  37.  
  38.     Selecting any of the items will present you with a prompt to enter the 
  39. data that you want to search on.  Don't worry about the capitilization  or 
  40. anything.  The fields that you have a choice to search on should be  self-
  41. explainatory.  If you choose more than one field to search on, you will be 
  42. given the option (after pressing return to begin the search) of  searching 
  43. for  users that match ALL or ANY of the field contents you  have  entered. 
  44. Selecting ALL will cause the program to search for users that match ALL of 
  45. the  search  criteria and ANY will cause the program to search  for  users 
  46. that match ANY of the search criteria.
  47.  
  48.     If a user is found that matches the search criteria, you will be given 
  49.     a choice of options.
  50.  
  51.     [A]gain will display the user again.
  52.  
  53.     [C]ontinue will continue the search (also you can press return here).
  54.  
  55.     [Q]uit will abort the search.
  56.  
  57.     [P]rint will print out the user on your printer.
  58.  
  59.     [W]rite will send the display to a disk file.  You must have entered a 
  60.     disk  filename in the 'Options' section for this to  work.  This  will 
  61.     Append the  user  to the file.  You must delete the file if  you  want 
  62.     to start over.
  63.         
  64.     [L]abel  will print a mailing label of the user.  The 'Options'  under 
  65.     the  'Mailing List' section will affect the output of this  label.  If 
  66.     you  have  output  to  Screen  on  then  it  will  print  it  to   the 
  67.     screen/modem.
  68.  
  69.  
  70. 2)  Options:
  71.     This will take you to a menu that will give you some options.  Some of 
  72. these are,  Send output to printer,  Send output to disk file,  Continuous 
  73. Scroll and Mailing List,  which will take you to another menu to setup the 
  74. options for the mailing list.  Most of these choices are toggles that  you 
  75. can toggle on and off.
  76.  
  77.     OPTIONS MENU
  78.     ------------
  79.  
  80.     1)  Send Output to Printer
  81.         This  will send the output of 'List All  Users' to the  printer.
  82.         You can press Control C at anytime to abort the  printout.  This
  83.         will not flush any printer buffer you  may  have though.
  84.  
  85.     2)  Send Output to Disk File
  86.         This will toggle the output to the file set in option 3. It will
  87.         toggle it on/off. This only effects  'List All Users'.  Pressing
  88.         Control C will abort the output.
  89.  
  90.     3)  Disk Filename
  91.         When you choose this option, you will be prompted for  the  path
  92.         and filename of the file you wish to send the output to. This was
  93.         added so that when you turned off output to disk, you would not
  94.         have to enter the filename again when you wanted it back on.
  95.  
  96.     4)  Continuous Scroll
  97.         This  will send the output of the searches and 'List ALL  Users' 
  98.         in a continuous manner without prompts between each  user.  This 
  99.         is handy if you want a listing and you are using the system from 
  100.         a remote and do not want to be prompted between users.
  101.  
  102.     5)  Exit to Main Menu
  103.         This does just what it says.
  104.  
  105. 3)  List ALL users:
  106.      This will print out all users found in the UserLog.  Several  of  the 
  107. options will affect the output of this listing.  The default output is  to 
  108. the screen and/or the modem, depending on if the program has been ran from 
  109. the remote end or the keyboard. Send output to  Disk  File and  Continuous 
  110. Scroll will affect this selection.  If Continuous Scroll is OFF,  you will 
  111. be given the same choices as you are under the Search User area.
  112.  
  113. 4)  Mailing List
  114.      This will take you a menu that allows you to setup the parameters for 
  115. the Mailing List.  You may need to play with the different settings to get 
  116. the desired output.
  117.  
  118.     MAILING LIST MENU
  119.     -----------------
  120.  
  121.     1) Left Margin will allow you to set the Left  Margin  amount. 
  122.        This  will set how many spaces from the left you  want  the 
  123.        printout to start printing.
  124.  
  125.     2) Linefeeds will tell the program how many lines  are  between 
  126.        each row of the labels.
  127.  
  128.     3) Labels  Across  will tell the program how  many  labels  are 
  129.        across the page. Normally it will only be 1. 
  130.  
  131.     4)  Label  Spacing is used in conjunction with item  3  above.  It  is 
  132.         the  number  of spaces that should be skipped  between  each label 
  133.         across.
  134.  
  135.  
  136.  
  137.     5)  #  of  Columns  is the number of characters  that  can  be  placed 
  138.         on the label. 
  139.  
  140.     6) TOF Spacing is the number of linefeeds to be sent before  printing 
  141.        the first row of labels.  On a Deskjet, 3 is the usual number using 
  142.        Avery 5260 labels.
  143.  
  144.     7) Labels Down is the number of rows of labels on  a  page.  Normally 
  145.        this is only used for Deskjet and Laser Printer owners.  For Avery 
  146.        5260 labels, this would be 10.
  147.  
  148.     8) Output  to  is where you  select to  either  send  the  labels  to 
  149.        Screen/Modem or Printer. Disk printing may be added later.
  150.  
  151.     9) Print Mailing List is where you tell the program to  start  priting 
  152.        the labels.
  153.  
  154. 5)  Save Configuration:
  155.      This  will  allow you to save all of your  settings.  Each  time  the 
  156. program  is  ran,  it  will look for the PRINTUSR.DAT file  and  load  the 
  157. settings in. This will allow you to configure the program the way you want 
  158. it  to  boot up each time.  Included in this archive is an example  of  my 
  159. PRINTUSR.DAT file.  It has the numbers for using a Deskjet and Avery  5260 
  160. labels.
  161.  
  162.    That is about it for now.  I plan to add some things later on.  If  you 
  163. have a suggestion for improvements or features,  please leave me E-mail on 
  164. the Transcendence Support BBS at 1-502-897-1589 or call Support Line 2  at 
  165. 1-803-879-4186. I go by Wayne Watson on Line 1 and I am Sysop on line 2.
  166.  
  167.    This  program  MUST  be placed on the same drive  that  you  keep  your 
  168. UserLog on.  It assumes that the file is in the \DATA\ folder.  You  do 
  169. not need to have it in the same folder, just the same drive.
  170.  
  171. This version uses a text file that you define. I figured it would be better
  172. to allow the sysop to define what he wants to print out. What may be
  173. important to me, may not be important to you. It is fairly flexable. Read
  174. the file PU_TAGS.TXT so that you will know what tags to use. The file
  175. pretty much explains how to make it up. I have included a copy of my text
  176. file as an example. This file MUST be called 'USERS.TXT